---
title: 라디오
image: /images/user-guide/create-workspace/workspace-cover.png
---

<Frame>
  <img src="/images/user-guide/create-workspace/workspace-cover.png" alt="Header" />
</Frame>

사용자가 여러 옵션 중에서 하나만 선택할 수 있을 때 사용됩니다.

<Tabs>
<Tab title="Usage">

```jsx
import { Radio } from "twenty-ui/display";

export const MyComponent = () => {

  const handleRadioChange = (event) => {
    console.log("Radio button changed:", event.target.checked);
  };

  const handleCheckedChange = (checked) => {
    console.log("Checked state changed:", checked);
  };


  return (
    <Radio
      checked={true}
      value="Option 1"
      onChange={handleRadioChange}
      onCheckedChange={handleCheckedChange}
      size="large"
      disabled={false}
      labelPosition="right"
    />
  );
};

```

</Tab>
<Tab title="Props">

| 프로퍼티            | 유형             | 설명                                                                                    |
| --------------- | -------------- | ------------------------------------------------------------------------------------- |
| 스타일             | `React.CSS` 속성 | 컴포넌트의 추가 인라인 스타일                                                                      |
| 클래스 네임          | 문자열            | 추가 스타일링을 위한 선택적 CSS 클래스                                                               |
| 체크됨             | 부울             | 라디오 버튼이 체크되었는지 여부를 나타냅니다                                                              |
| 값               | 문자열            | 라디오 버튼과 연결된 라벨 또는 텍스트                                                                 |
| onChange        | function       | 선택된 라디오 버튼이 변경될 때 호출되는 기능                                                             |
| onCheckedChange | function       | 라디오 버튼의 `체크` 상태가 변경될 때 호출되는 기능                                                        |
| 크기              | 문자열            | 라디오 버튼의 크기입니다. 옵션에는 `large`와 `small`이 포함됩니다                           |
| disabled        | 부울             | `참`이면 라디오 버튼이 비활성화되어 클릭할 수 없습니다                                                       |
| 라벨 위치           | 문자열            | 라벨 텍스트의 라디오 버튼에 대한 상대 위치입니다. 두 가지 옵션: `left`와 `right` |

</Tab>
</Tabs>

## 라디오 그룹

관련된 라디오 버튼들을 그룹화합니다.

<Tabs>
<Tab title="Usage">

```jsx
import React, { useState } from "react";
import { Radio, RadioGroup } from "twenty-ui/display";

export const MyComponent = () => {

  const [selectedValue, setSelectedValue] = useState("Option 1");

  const handleChange = (event) => {
    setSelectedValue(event.target.value);
  };
  
  return (
    <RadioGroup value={selectedValue} onChange={handleChange}>
      <Radio value="Option 1" />
      <Radio value="Option 2" />
      <Radio value="Option 3" />
    </RadioGroup>
  );
};

```

</Tab>
<Tab title="Props">

| 프로퍼티          | 유형                | 설명                                                 |
| ------------- | ----------------- | -------------------------------------------------- |
| 값             | 문자열               | 현재 선택된 라디오 버튼의 값                                   |
| onChange      | function          | 라디오 버튼이 변경될 때 트리거되는 콜백 기능                          |
| onValueChange | function          | 그룹에서 선택된 값이 변경될 때 트리거되는 콜백 기능.     |
| children      | `React.ReactNode` | Radio와 같은 React 컴포넌트를 자식으로 Radio Group에 전달할 수 있습니다 |

</Tab>

</Tabs>
